Skip to main content
POST
/
fleet
/
assets
/
device-recovery
/
{id}
/
recovered
[beta] Mark an asset as recovered.
curl --request POST \
  --url https://api.samsara.com/fleet/assets/device-recovery/{id}/recovered \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "missing_reason": "MISPLACED",
  "recovery_status": "YES",
  "status": "RECOVERED",
  "additional_details": "Found in warehouse B"
}
'
{
  "data": {
    "id": "12345",
    "name": "Trailer-A1234",
    "updated_at_ms": 1609459200000,
    "note": "Asset was last seen at warehouse A",
    "notification_recipients": [
      {
        "email": "jane.doe@example.com",
        "name": "Jane Doe",
        "notification_types": [
          "email"
        ],
        "user_id": 1234
      }
    ],
    "recovery_photos": [
      {
        "start_ms": 1609459200000,
        "status": "EXISTS",
        "url": "https://s3.amazonaws.com/samsara-recovery-photos/example.jpg",
        "url_expires_at_ms": 1609462800000
      }
    ],
    "update_source": "dashboard",
    "updated_by_user_id": 1234
  }
}

Documentation Index

Fetch the complete documentation index at: https://samsara-showcase.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

The ID of the asset. This can be a Samsara internal ID or an external ID in the format key:value.

Body

application/json

Request body for recovering an asset.

​
missing_reason
enum<string>
required

The reason the asset was marked as missing. Valid values: MISPLACED, STOLEN, NOT_SURE

Available options:
MISPLACED,
STOLEN,
NOT_SURE
Example:

"MISPLACED"

​
recovery_status
enum<string>
required

Whether the asset has been physically recovered. Valid values: YES, NO, NOT_SURE

Available options:
YES,
NO,
NOT_SURE
Example:

"YES"

​
status
enum<string>
required

The recovery status to set for the asset. Valid values: RECOVERED

Available options:
RECOVERED
Example:

"RECOVERED"

​
additional_details
string

Optional additional details about the recovery.

Example:

"Found in warehouse B"

Response

OK response.

​
data
object
required

A recovered asset with its recovery details, including recovery photos.